%> @file tool_function_forshow.m
%> @brief This is an example of a MATLAB function to show the main capabilities of the documentation using Doxygen, LaTeX, and an on-the-fly Perl script.
%> @author Mikhail V. Konnik
%> @date   22 August 2011
%>
%> @section functionforshow Documentation of a MATLAB funciton.
%> This test function shows how to document MATLAB functions in the described framework. The main points are:
%> - the names of input parameters (param) and return values (retval) must coincide with the names used in the function itself;
%> - it is a good practice to write the expected type/size of variables;
%> - the function(s) can contain brief descriptions as well.
%> All the rest mark-up is valid for functions, scripts, and classes.
%======================================================================
%> @brief Test function to show the documentation of MATLAB functions.
%> @param grad_row           =  gradients matrix for ROWS [N-by-N]
%> @param grad_col           =  gradients matrix for COLUMNS [N-by-N]
%>
%> @retval a                 = coefficients of reconstructed Zernike functions.
% ======================================================================
function a = tool_function_forshow(grad_row, grad_col);

%....